GXSetStyleCurveError
You can use theGXSetStyleCurveError
function to change the curve error of a style object.
void GXSetStyleCurveError(gxStyle target, Fixed error);
target
- A reference to the style object whose curve error you want to change.
error
- The new curve error.
DESCRIPTION
This routine sets the curve error of the style object specified by the target parameter to be the fixed-point value specified by theerror
parameter. You may specify any nonnegative value for this parameter.When a path shape has a curve error of 0.0, QuickDraw GX does not approximate the path shape with a polygon shape when converting it to a polygon. Instead, QuickDraw GX simply removes off-curve control points, as shown in "Using Curve Error When Converting Paths to Polygons" on page 3-45.
A very small curve error may cause the
GXSetShapeType
function and certain geometric operations such as theGXInsetShape
function to use inappropriate amounts of memory and time.When you set a style's curve error using this function, you are effectively changing the curve error for all shapes that share the style.
ERRORS, WARNINGS, AND NOTICES
Errors out_of_memory style_is_nil parameter_out_of_range (debugging version) Notices (debugging version) curve_error_already_set SEE ALSO
For a discussion of curve error, see "Curve Error" on page 3-14.For examples of curve error, see "Using Curve Error When Converting Paths to Polygons" on page 3-45 and "Using Curve Error When Reducing Shapes" on page 3-49.
To determine the curve error of a style object, use the
GXGetStyleCurveError
function, which is described on page 3-115.To examine the curve error of a style object associated with a particular shape, use the
GXGetShapeCurveError
function, which is described in the next section. To change the curve error of a style object associated with a particular shape, use theGXSetShapeCurveError
function, which is described on page 3-118.
Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help